XML.addRequestHeader()

Доступность

Flash Player 6.

Синтаксис

my_xml.addRequestHeader(headerName:String, headerValue:String) : Void
my_xml.addRequestHeader(["headerName_1":String, "headerValue_1":String ... "headerName_n":String, "headerValue_n":String]) : Void

Параметры

headerName Строка, определяющая имя заголовка HTTP запроса.

headerValue Строка, определяющая значение, связанное с headerName.

Возвращает

Ничего.

Описание

Метод; добавляет или изменяет заголовки HTTP запросов (таких как, например, Content-Type или SOAPAction), посылаемых методом POST. В при использовании первого варианта синтаксиса методу передается два параметра-строки: headerName и headerValue. В случае использования второго синтаксиса Вы передаете любое четное число альтернативных заголовков в виде пар "имя, значение".

Если осуществляется несколько вызовов метода, изменяющих один и тот же заголовок, каждый последующий удаляет результат предыдущего успешного вызова.

При помощи этого метода Вы не можете добавить или изменить следующие стандартные HTTP заголовки: Accept-Ranges, Age, Allow, Allowed, Connection, Content-Length, Content-Location, Content-Range, ETag, Host, Last-Modified, Locations, Max-Forwards, Proxy-Authenticate, Proxy-Authorization, Public, Range, Retry-After, Server, TE, Trailer, Transfer-Encoding, Upgrade, URI, Vary, Via, Warning и WWW-Authenticate.

Пример

В примере ниже к HTTP запросу, связанному с XML объектом my_xml добавляется пользовательский заголовок SOAPAction, имеющий значение Foo:

my_xml.addRequestHeader("SOAPAction", "'Foo'");

В примере ниже создается массив headers, содержащий два альтернативных HTTP заголовка и их значения. Массив передается как параметр для метода addRequestHeader().

var headers:Array = new Array("Content-Type", "text/plain", 
"X-ClientAppVersion", "2.0");
my_xml.addRequestHeader(headers);

См. также

LoadVars.addRequestHeader()

Смотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление